<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<link rel="STYLESHEET" href="lib.css" type='text/css' />
<link rel="SHORTCUT ICON" href="../icons/pyfav.png" type="image/png" />
<link rel='start' href='../index.html' title='Python documentation Index' />
<link rel="first" href="lib.html" title='Python library Reference' />
<link rel='contents' href='contents.html' title="Contents" />
<link rel='index' href='genindex.html' title='Index' />
<link rel='last' href='about.html' title='About this document...' />
<link rel='help' href='about.html' title='About this document...' />
<link rel="next" href="module-al-constants.html" />
<link rel="prev" href="sgi.html" />
<link rel="parent" href="sgi.html" />
<link rel="next" href="al-config-objects.html" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name='aesop' content='information' />
<title>34.1 al -- Audio functions on the SGI</title>
</head>
<body>
<div class="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="34. sgi IRIX Specific"
  href="sgi.html"><img src='../icons/previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="34. sgi IRIX Specific"
  href="sgi.html"><img src='../icons/up.png'
  border='0' height='32'  alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><a rel="next" title="34.1.1 configuration Objects"
  href="al-config-objects.html"><img src='../icons/next.png'
  border='0' height='32'  alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">Python Library Reference</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
  href="contents.html"><img src='../icons/contents.png'
  border='0' height='32'  alt='Contents' width='32' /></a></td>
<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
  border='0' height='32'  alt='Module Index' width='32' /></a></td>
<td class='online-navigation'><a rel="index" title="Index"
  href="genindex.html"><img src='../icons/index.png'
  border='0' height='32'  alt='Index' width='32' /></a></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="sgi.html">34. SGI IRIX Specific</a>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="sgi.html">34. SGI IRIX Specific</a>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="al-config-objects.html">34.1.1 Configuration Objects</a>
</div>
<hr /></div>
</div>
<!--End of Navigation Panel-->

<h1><a name="SECTION0036100000000000000000">
34.1 <tt class="module">al</tt> --
         Audio functions on the SGI</a>
</h1>

<p>
<a name="module-al"></a>  
<p class="availability">Availability: <span
 class="platform">IRIX</span>.</p>

<p>
This module provides access to the audio facilities of the SGI Indy
and Indigo workstations.  See section 3A of the IRIX man pages for
details.  You'll need to read those man pages to understand what these
functions do!  Some of the functions are not available in IRIX
releases before 4.0.5.  Again, see the manual to check whether a
specific function is available on your platform.

<p>
All functions and methods defined in this module are equivalent to
the C functions with "<tt class="samp">AL</tt>" prefixed to their name.

<p>
Symbolic constants from the C header file <code>&lt;audio.h&gt;</code> are
defined in the standard module
<tt class="module"><a href="module-al-constants.html">AL</a></tt><a id='l2h-5554' xml:id='l2h-5554'></a>, see below.

<p>
<span class="warning"><b class="label">Warning:</b>
The current version of the audio library may dump core
when bad argument values are passed rather than returning an error
status.  Unfortunately, since the precise circumstances under which
this may happen are undocumented and hard to check, the Python
interface can provide no protection against this kind of problems.
(One example is specifying an excessive queue size -- there is no
documented upper limit.)</span>

<p>
The module defines the following functions:

<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
  <td><nobr><b><tt id='l2h-5549' xml:id='l2h-5549' class="function">openport</tt></b>(</nobr></td>
  <td><var>name, direction</var><big>[</big><var>, config</var><big>]</big><var></var>)</td></tr></table></dt>
<dd>
The name and direction arguments are strings.  The optional
<var>config</var> argument is a configuration object as returned by
<tt class="function">newconfig()</tt>.  The return value is an <i class="dfn">audio port
object</i>; methods of audio port objects are described below.
</dl>

<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
  <td><nobr><b><tt id='l2h-5550' xml:id='l2h-5550' class="function">newconfig</tt></b>(</nobr></td>
  <td><var></var>)</td></tr></table></dt>
<dd>
The return value is a new <i class="dfn">audio configuration object</i>; methods of
audio configuration objects are described below.
</dl>

<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
  <td><nobr><b><tt id='l2h-5551' xml:id='l2h-5551' class="function">queryparams</tt></b>(</nobr></td>
  <td><var>device</var>)</td></tr></table></dt>
<dd>
The device argument is an integer.  The return value is a list of
integers containing the data returned by <tt class="cfunction">ALqueryparams()</tt>.
</dl>

<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
  <td><nobr><b><tt id='l2h-5552' xml:id='l2h-5552' class="function">getparams</tt></b>(</nobr></td>
  <td><var>device, list</var>)</td></tr></table></dt>
<dd>
The <var>device</var> argument is an integer.  The list argument is a list
such as returned by <tt class="function">queryparams()</tt>; it is modified in place
(!).
</dl>

<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
  <td><nobr><b><tt id='l2h-5553' xml:id='l2h-5553' class="function">setparams</tt></b>(</nobr></td>
  <td><var>device, list</var>)</td></tr></table></dt>
<dd>
The <var>device</var> argument is an integer.  The <var>list</var> argument is a
list such as returned by <tt class="function">queryparams()</tt>.
</dl>

<p>

<p><br /></p><hr class='online-navigation' />
<div class='online-navigation'>
<!--Table of Child-Links-->
<a name="CHILD_LINKS"><strong>Subsections</strong></a>

<ul class="ChildLinks">
<li><a href="al-config-objects.html">34.1.1 Configuration Objects</a>
<li><a href="al-port-objects.html">34.1.2 Port Objects</a>
</ul>
<!--End of Table of Child-Links-->
</div>

<div class="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="34. sgi IRIX Specific"
  href="sgi.html"><img src='../icons/previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="34. sgi IRIX Specific"
  href="sgi.html"><img src='../icons/up.png'
  border='0' height='32'  alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><a rel="next" title="34.1.1 configuration Objects"
  href="al-config-objects.html"><img src='../icons/next.png'
  border='0' height='32'  alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">Python Library Reference</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
  href="contents.html"><img src='../icons/contents.png'
  border='0' height='32'  alt='Contents' width='32' /></a></td>
<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
  border='0' height='32'  alt='Module Index' width='32' /></a></td>
<td class='online-navigation'><a rel="index" title="Index"
  href="genindex.html"><img src='../icons/index.png'
  border='0' height='32'  alt='Index' width='32' /></a></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="sgi.html">34. SGI IRIX Specific</a>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="sgi.html">34. SGI IRIX Specific</a>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="al-config-objects.html">34.1.1 Configuration Objects</a>
</div>
</div>
<hr />
<span class="release-info">Release 2.5.1, documentation updated on 18th April, 2007.</span>
</div>
<!--End of Navigation Panel-->
<address>
See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
</address>
</body>
</html>
